<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html lang="en">
<head>

<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link REL="STYLESHEET" HREF="../../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Eclipse launch configuration</title>
</head>

<body>
<h1>Eclipse launcher configuration</h1>
<h2>Description</h2>
<p>
When starting Eclipse there are many command-line arguments which are valid
to pass along to the executable. Rather than creating a shortcut or script for
launching, users are able to create a launcher configuration file which will be
read by the executable on startup.
</p><p>
The format of the launcher configuration file is as follows:
</p>
<ul>
<li>The configuration file must have the same name as the executable itself, with a file
extension of <code>.ini</code>. For instance, the default launcher configuration file
is called <code>eclipse.ini</code>.</li>
<li>The file must contain only one command-line argument per line.</li>
<li>Whitespace is important...there cannot be any extra spaces at the end of each line.</li>
<li>The file should be located as a sibling of the executable.</li>
</ul>
<p>
Sample file content:</p>
<blockquote><pre><code>
-vm
c:/path/to/my/java.exe
-debug
-console
-data
d:/path/to/my/workspace
-vmargs
-Xmx384m
</code></pre></blockquote>

</body>
</html>
